NavNewFolder

NavNewFolder
Header:	Navigation.h		Carbon status:	Supported

Displays a dialog box that prompts the user to create a new folder.

OSErr NavNewFolder (
    AEDesc *defaultLocation, 
    NavReplyRecord *reply, 
    NavDialogOptions *dialogOptions, 
    NavEventUPP eventProc, 
    void *callBackUD
);

defaultLocation: A pointer to an Apple event descriptor structure (AEDesc). Before calling NavNewFolder, you can set up a structure of AEDesc type 'typeFSS' to specify a default location to be viewed. If you pass NULL in this parameter, Navigation Services displays the last location visited during a call to the NavNewFolder function. If the file system specification in the AEDesc structure does not describe a directory or volume, Navigation Services uses the desktop as the default location.
reply: A pointer to a structure of type NavReplyRecord. Upon return, Navigation Services uses this structure to provide data to your application about the results of the NavNewFolder function call.
dialogOptions: A pointer to a structure of type NavDialogOptions. Before calling NavNewFolder, set up this structure to specify dialog box settings. If you pass NULL in this parameter, Navigation Services uses the defaults for all options. See “Dialog Option Configuration Constants” for a description of the default settings.
eventProc: A Universal Procedure Pointer (UPP) of type NavEventProcPtr that points to your application-defined event-handling function. You obtain this UPP by calling the macro NewNavEventProc. Implementing an event-handling function allows your application to update windows after the user moves or resizes the dialog box. If you pass NULL in this parameter, the dialog box is not movable or resizable. For more information, see “Handling Events”.
callBackUD: A pointer to a value set by your application. When the NavNewFolder function calls your event-handling function, the callBackUD value is passed back to your application.

function result: A result code.

DISCUSSION

This function provides a way for your application to prompt the user to create a new folder. This might be useful for creating a project folder, for example.

VERSION NOTES

Available in Navigation Services 1.0 and later.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when NavigationLib 1.0 or later is installed. Exported by CarbonLib 1.0 and later and by NavigationLib 1.0 and later.